Skip to main content

Fetching Collections

Collections are thematic groupings of music clips that are developed and maintained by Feed's Curation team and available for end users to browse through via the Clips API. This is the primary way for users to discover music within your app.

All or Multiple Collections​

You can retrieve a list of all available collections using the collections endpoint without any specific collectionIds in the request.

To request specific Collections, include the relevant ids in the request.

POST /collections

Request Body:

{  
  "clientId": "YOUR_CLIENT_ID",
  "timestamp": "2024-10-26T10:00:00Z",
  "collectionIds": [1, 2, 3]
}

Note: Only clientId is required. timestampis optional.

Response:

{
  "collections": [
    {
      "collectionId": 1,
      "collectionName": "Summer Vibes",
      "publishedOn": "2025-07-28T17:22:10.000Z",
      "clips": [
        {
          "clipId": 123,
          "trackId": 456,
          "artworkPreSignedUrl": "https://...",
          "title": "Summer Song",
          "artist": "Summer Artist",
          "album": "Summer Album",
          "duration": 60,
          "preSignedUrl": "https://...",
          "preSignedUrlExpires": "2024-10-27T10:00:00Z",
          "encoding": "aac",
          "bitrate": "128",
          "createDate": "2025-10-21T16:15:57.000Z",
          "isrc": "USWB12200122",
          "explicitness": "clean"
        }
      ]
    }
  ]
}

Individual Collections​

POST /collection If you want to request a particular Collection, use this endpoint with the specific collectionID included in the request.

Request Body:

{  
  "clientId": "YOUR_CLIENT_ID",  
  "collectionId": 1,
  "timestamp": "2024-10-26T10:00:00Z",
}

Note: clientId and collectionId are required. timestamp is optional.

Response:

{
  "collectionId": 1,
  "collectionName": "Summer Vibes",
  "publishedOn": "2025-07-28T17:22:10.000Z",
  "clips": [
    {
      "clipId": 123,
      "trackId": 456,
      "artworkPreSignedUrl": "https://...",
      "title": "Summer Song",
      "artist": "Summer Artist",
      "album": "Summer Album",
      "duration": 60,
      "preSignedUrl": "https://...",
      "preSignedUrlExpires": "2024-10-27T10:00:00Z",
      "encoding": "aac",
      "bitrate": 128,
      "createDate": "2025-10-21T16:15:57.000Z",
      "isrc": "USWB12200122",
      "explicitness": "unknown"
    }
  ]
}